home *** CD-ROM | disk | FTP | other *** search
/ Aminet 19 / Aminet 19 (1997)(GTI - Schatztruhe)[!][Jun 1997].iso / Aminet / docs / misc / ahiman.readme < prev    next >
Encoding:
Text File  |  1997-05-03  |  8.0 KB  |  200 lines
  1. Short:    Retargetable audio v4, Doc. Archive
  2. Author:   Martin Blom <lcs@lysator.liu.se>
  3. Uploader: Martin Blom <lcs@lysator.liu.se>
  4. Type:     docs/misc
  5.  
  6.      This archive contains the documentation for AHI (both
  7.      AHI Developer's Guide and AHI User's Guide) as DVI,
  8.      Postscript and HTML files.
  9.  
  10.      AmigaGuide® versions are included in the AHI Developer's
  11.      archive and the AHI User's archive.
  12.  
  13. TITLE
  14.  
  15.      AHI Audio system
  16.  
  17. VERSION
  18.  
  19.      Release 4
  20.  
  21. AUTHOR
  22.  
  23.      Martin Blom <lcs@lysator.liu.se>
  24.  
  25. DESCRIPTION
  26.  
  27.      Retargetable Audio for AmigaOS
  28.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  29.  
  30.      (When refering to this software, the correct term is
  31.      'AHI audio system' or just 'AHI', never 'Audio Hardware
  32.      Interface'! 'AHI' is pronounced 'atchii', as in 'God bless!'.)
  33.  
  34.      Starting with version 3 of AHI, the MC68000 processor is also supported.
  35.      However, many features are lacking:
  36.  
  37.      · 16 bit samples are converted to 8 bits before they are mixed.
  38.      · No HiFi mixing routines are available.
  39.      · No stereo samples
  40.      · No DSP effects are available.
  41.      · Less precision on some calculations
  42.      · Slower
  43.  
  44.      As you can see, this version is very primitive.  Get yourself an
  45.      accelerator!  I cannot guarantee that I will continue to support this
  46.      processor in the future.
  47.  
  48.      Quick overview
  49.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  50.  
  51.      * Driver based
  52.  
  53.      Each supported sound card is controlled by a library-based audio
  54.      driver. For a 'dumb' sound card, a new driver should be written in
  55.      a few hours. For a 'smart' sound card, it is possible to utilize an
  56.      on-board DSP, for example, to maximize performance and sound quality.
  57.      For sound cards with own DSP but little or no memory, it is possible
  58.      to use the main CPU to mix channels and do the post-processing
  59.      with the DSP. Available today are drivers for
  60.  
  61.      · Aura (sampler only)
  62.      · Delfina
  63.      · DraCo Motion
  64.      · Paula (8/14/14c bit)
  65.      · Prelude
  66.      · Toccata
  67.      · Wavetools
  68.      · 8SVX (mono) and AIFF/AIFC (mono & stereo) sample render
  69.  
  70.      * Fast, powerful mixing routines (yeah, right... haha)
  71.  
  72.      The device's mixing routines mix 8- or 16-bit signed samples, both
  73.      mono and stereo, located in Fast-RAM and outputs 16-bit mono or stereo
  74.      (with stereo panning if desired) data, using any number of channels
  75.      (as long as 'any' means less than 128...).  Tables can be used speed
  76.      the mixing up (especially when using 8-bit samples).  The samples can
  77.      have any length (including odd) and can have any number of loops.
  78.      
  79.      * Support for non-realtime mixing
  80.  
  81.      By providing a timing feature, it is possible to create high-
  82.      quality output even if the processing power is lacking, by saving
  83.      the output to disk, for example as an IFF AIFF or 8SXV file.
  84.      There are so-called HiFi mixing routines that can be used, which
  85.      use linear interpolation and gives 32 bit output.
  86.  
  87.      * Audio database
  88.  
  89.      Uses ID codes, much like Screenmode IDs, to select the many
  90.      parameters that can be set. The functions to access the audio
  91.      database are not too different from those in 'graphics.library'.
  92.      The device also features a requester to get an ID code from the
  93.      user.
  94.  
  95.      * Both high- and low-level protocol
  96.  
  97.      By acting both like a device and a library, AHI gives the programmer
  98.      a choice between full control and simplicity. The device API allows
  99.      several programs to use the audio hardware at the same time, and
  100.      the AUDIO: dos-device driver makes playing and recording sound very
  101.      simple for both the programmer and user.
  102.  
  103.      * Future Compatible
  104.  
  105.      When AmigaOS gets device-independent audio worth it's name, it should
  106.      not be too difficult to write a driver for AHI, allowing applications
  107.      using 'ahi.device' to automatically use the new OS interface. At
  108.      least I hope it wont.
  109.  
  110. SPECIAL REQUIREMENTS
  111.  
  112.      AmigaOS release 2.
  113.      MC68020 processor strongly recommended.
  114.  
  115. AVAILABILITY
  116.  
  117.      Aminet, for example:
  118.      ftp://ftp.germany.aminet.org/pub/aminet/dev/misc/ahidev.lha
  119.      ftp://ftp.germany.aminet.org/pub/aminet/mus/misc/ahiusr.lha
  120.      ftp://ftp.germany.aminet.org/pub/aminet/docs/misc/ahiman.lha
  121.  
  122.      WWW:
  123.      http://www.lysator.liu.se/~lcs/ahi.html
  124.  
  125. PRICE
  126.  
  127.      Free. But if you use it in a shareware of commercial product,
  128.      I would like a registered copy for me and each of the audio driver
  129.      authors (this is merely a wish, you don't have to do it if you don't
  130.      think we deserve it). See the AHI User's Guide for more information.
  131.  
  132. DISTRIBUTABILITY
  133.  
  134.      Copyright ©1994-1997 Martin Blom.
  135.      Freely distributable in unmodified form.
  136.      See the AHI User's Guide for more information.
  137.  
  138.  
  139. ============================= Archive contents =============================
  140.  
  141. Original  Packed Ratio    Date     Time    Name
  142. -------- ------- ----- --------- --------  -------------
  143.     4732    2206 53.3% 23-Apr-97 09:20:26 +ahiman.readme
  144.    92004   22296 75.7% 21-Apr-97 23:45:26 +ahidev.dvi
  145.    63652   18606 70.7% 21-Apr-97 23:43:40 +ahiusr.dvi
  146.     3553    1380 61.1% 21-Apr-97 23:48:34 +ahidev_1.html
  147.     6654    2468 62.9% 21-Apr-97 23:48:38 +ahidev_10.html
  148.     1866     834 55.3% 21-Apr-97 23:48:38 +ahidev_11.html
  149.     2878    1147 60.1% 21-Apr-97 23:48:38 +ahidev_12.html
  150.     2928    1099 62.4% 21-Apr-97 23:48:40 +ahidev_13.html
  151.     5430    2072 61.8% 21-Apr-97 23:48:40 +ahidev_14.html
  152.     1110     464 58.1% 21-Apr-97 23:48:40 +ahidev_15.html
  153.     1812     729 59.7% 21-Apr-97 23:48:40 +ahidev_16.html
  154.     1863     827 55.6% 21-Apr-97 23:48:40 +ahidev_17.html
  155.     3655     988 72.9% 21-Apr-97 23:48:40 +ahidev_18.html
  156.     1222     460 62.3% 21-Apr-97 23:48:42 +ahidev_19.html
  157.     2452    1141 53.4% 21-Apr-97 23:48:34 +ahidev_2.html
  158.     1428     479 66.4% 21-Apr-97 23:48:42 +ahidev_20.html
  159.     2754     726 73.6% 21-Apr-97 23:48:42 +ahidev_21.html
  160.     1165     532 54.3% 21-Apr-97 23:48:36 +ahidev_3.html
  161.     1727     764 55.7% 21-Apr-97 23:48:36 +ahidev_4.html
  162.     1818     767 57.8% 21-Apr-97 23:48:36 +ahidev_5.html
  163.     3118    1227 60.6% 21-Apr-97 23:48:36 +ahidev_6.html
  164.     2723    1074 60.5% 21-Apr-97 23:48:36 +ahidev_7.html
  165.     6138    2169 64.6% 21-Apr-97 23:48:38 +ahidev_8.html
  166.     3329    1436 56.8% 21-Apr-97 23:48:38 +ahidev_9.html
  167.      774     459 40.6% 21-Apr-97 23:48:34 +ahidev_foot.html
  168.     3751    1169 68.8% 21-Apr-97 23:48:34 +ahidev_toc.html
  169.     3586    1618 54.8% 21-Apr-97 23:47:22 +ahiusr_1.html
  170.     1153     522 54.7% 21-Apr-97 23:47:24 +ahiusr_10.html
  171.     1141     477 58.1% 21-Apr-97 23:47:24 +ahiusr_11.html
  172.      933     390 58.1% 21-Apr-97 23:47:24 +ahiusr_12.html
  173.     1948     863 55.6% 21-Apr-97 23:47:24 +ahiusr_13.html
  174.     2220    1040 53.1% 21-Apr-97 23:47:24 +ahiusr_14.html
  175.     4418    1819 58.8% 21-Apr-97 23:47:24 +ahiusr_15.html
  176.     1464     591 59.6% 21-Apr-97 23:47:24 +ahiusr_16.html
  177.     2512    1117 55.5% 21-Apr-97 23:47:26 +ahiusr_17.html
  178.     2646    1170 55.7% 21-Apr-97 23:47:26 +ahiusr_18.html
  179.     1395     594 57.4% 21-Apr-97 23:47:26 +ahiusr_19.html
  180.     2505    1149 54.1% 21-Apr-97 23:47:22 +ahiusr_2.html
  181.     2248    1085 51.7% 21-Apr-97 23:47:26 +ahiusr_20.html
  182.     1405     614 56.2% 21-Apr-97 23:47:26 +ahiusr_21.html
  183.     2128     989 53.5% 21-Apr-97 23:47:26 +ahiusr_22.html
  184.     1933     917 52.5% 21-Apr-97 23:47:26 +ahiusr_23.html
  185.     1388     568 59.0% 21-Apr-97 23:47:26 +ahiusr_24.html
  186.     3970    1091 72.5% 21-Apr-97 23:47:28 +ahiusr_25.html
  187.     1271     610 52.0% 21-Apr-97 23:47:22 +ahiusr_3.html
  188.     1130     454 59.8% 21-Apr-97 23:47:22 +ahiusr_4.html
  189.     2318    1044 54.9% 21-Apr-97 23:47:22 +ahiusr_5.html
  190.     2460    1032 58.0% 21-Apr-97 23:47:22 +ahiusr_6.html
  191.      994     375 62.2% 21-Apr-97 23:47:22 +ahiusr_7.html
  192.     1437     635 55.8% 21-Apr-97 23:47:22 +ahiusr_8.html
  193.     1182     479 59.4% 21-Apr-97 23:47:22 +ahiusr_9.html
  194.     2038    1061 47.9% 21-Apr-97 23:47:20 +ahiusr_foot.html
  195.     2282     796 65.1% 21-Apr-97 23:47:20 +ahiusr_toc.html
  196.   214409   81555 61.9% 21-Apr-97 23:46:14 +ahidev.ps
  197.   172415   68461 60.2% 21-Apr-97 23:45:56 +ahiusr.ps
  198. -------- ------- ----- --------- --------
  199.   665465  240635 63.8% 23-Apr-97 17:32:48   55 files
  200.